Copyright: RightFAX @1995


CONTENTS


LogLevel

Description:

Specifies the level of information logged in the file APPLICATION EventLog.  A value of TERSE will cause the RightFAX WorkServer Module Service to record only critical errors,  while the VERBOSE setting will record significant amounts of information which may help track down problems.

Information written to the APPLICATION EventLog is invaluable in tracking down problems.  If you have a problem which you can duplicate, you should set the LOGLEVEL for all server programs to VERBOSE, and then go through the steps to duplicate the problem.  The data stored in the various logs may help you solve the problem yourself, but if the answer is not obvious, it will greatly speed up the process of locating a problem if you can provide RightFAX Technical Support with the log file information.

Do NOT leave this value set to VERBOSE for any length of time, as the APPLICATION EventLog can grow quite large.


Services

Description:

The RightFAX WorkServer Module Service is a program which executes fax conversions, form merges, print jobs, and other various tasks.  To specify which SERVICES, RightFAX WorkServer Module Service should perform, use the following keywords:

Keyword 	 Service

PCL5 	HP-PCL5 to Fax conversion

POSTSCRIPT 	PostScript to Fax conversion (Requires POSTSCRIPT Module)

OVERLAY 	Adding form types

PRINT 	Servicing auto-print or spooled print requests

ARCHIVE 	Servicing auto-print or auto-archiving of sent faxes

FILEROUTE 	Servicing auto-routing received faxes to a network directory

OCR 	Optical Character Recognition (Requires OCR Module)

COVERSHEETS 	Creating coversheets

CVL 	Servicing faxes with multiple LIBDOC, LIBDOC2, ADDDOC or ADDDOC2 codes

ALT1PCL 	An alternate to PCL, useful for specifying letter -vs- legal paper size

ALT1PS 	An alternate to POSTSCRIPT, useful for specifying letter -vs- legal paper size

SYNCFOD 	Synchronizing IBEX fax library with RightFAX Library documents (Requires LIBSYNC Module)

NETWORK MESSAGING	Servicing network broadcast notifications

Notes:

By default, all RightFAX WorkServer Module Services perform Network Broadcasting.  This means, even if you do NOT supply any SERVICES for the RightFAX WorkServer Module Service, it will perform Network Broadcasting.

If you want to run multiple RightFAX WorkServer Module Services to handle different tasks, then increase the NUMWORKSERVERS in the RightFAX WorkServer Applet.  And then toggle through each new RightFAX WorkServer Module Service, by using the SELECT WORKSERVER TO EDIT , setting separate SERVICES or the same SERVICES for each.


EquiTrac Archive
Archive

EquiTrac Archive

Description:

If enabled, and ARCHIVE appears in the SERVICES selection box, the RightFAX WorkServer Module Service will archive a record of all successfully sent faxes to a file called RIGHTFAX.TXT in the RightFAX WorkServer Module Service's directory.  In the file, the following fields will be recorded, one fax per record/line:

Field                                          	Maximum Length/Format

RightFAX User ID	21 characters

Phone Number Dialed	31 characters

BillInfo1	15 characters

BillInfo2	15 characters

Fax Transmission Duration	HH:MM:SS

Fax Error Code	Always the number 32, indicating success

Number of pages in fax	###

Fax Date	MM/DD/YY

Fax Time	HH:MMEach fax record/line is terminated with a carriage-return line-feed (CR-LF) combination.  All the fields are seperated with a comma character and no commas will appear in the field data, thus a bad field separator will be accidently placed into the file.

The RIGHTFAX.TXT file is only open for the time it takes to write a single record/line, a split second at most.  However, file contention must still be dealt with, else if the EquiTrac system were attempting to read the RIGHTFAX.TXT file while RightFAX WorkServer Module Service attempted to write it, a collision would occur.  To prevent such a collision, it is recommended that any program which imports the RIGHTFAX.TXT file should first rename it.  Since RightFAX WorkServer Module Service will automatically create a new RIGHTFAX.TXT if none exists, the rename is a simple way of "grabbing" the last set of records written.

For a user's faxes to be recorded into RIGHTFAX.TXT, the Archive Sent Faxes attribute must be enabled on the User record (use FaxAdmin to enable the flag).  Enabling Archive Sent Faxes will disable any automatic sent fax deletion options a user has attempted to employ and the user will not be notified of the fact that auto-delete was implicitly turned off.  Thermal Fax Records and unsuccessful faxes are NOT recorded.

See also Archive Path, Archive History, Archive Index and Archive Format.


Archive

Format

Description:

When archiving faxes to disk, files are normally stored in a multi-paged TIFF-G3 format with Group III data compression.  If a sent fax has a cover sheet, it will be archived as well.  The FORMAT option allows the default format of TIFF-G3 to be changed to PCX or DCX.

See also Archive Path, Archive History, Archive Index and EquiTrac Archive.


Archive

Index

Description:

When archiving faxes to disk, an INDEX file can be created which describes all the faxes which were saved to disk.  Below is the description of the INDEX file which will be created, if this option is specified.

FIELD	TYPE 	MAXLENGTH 	NOTES

owner_id	string	21

to_faxnum	string	31

to_contractnum	string	31

to_name	string	59

to_company	string	59

to_citystate	string	59

from_name	string	59

from_phonenum	string	31

billinfo1	string	15

billingo2	string	15

faxdidnum	string	31

operatornum	string	31

remoteid	string	21

send_time	int	total elapsed time on fax card, in seconds

fax_status	int

fax_termstat	int

numpages	int	includes optional cover sheet, if any

finemode	int	0 = normal, 1= fine

RECEIVED	int	0 =sent, 1 = receive

faxdate	string	10	date fax record last modified (mm/dd/yyyy)

faxtime	string	5	time fax record lasr modified (hh:mm)

Archived_Name	string	256	Path and file name under which the image was archived

NEWLINE (CR-LF combination record seperator)

See also Archive Path, Archive History, Archive Format and EquiTrac Archive.


Archive

History

Description:

Automatically archives the tramsmission history of the sent fax.  It creates a file based on the Archive Path format and the Archive Format with the extension of .TRX, e.g. 21494.TRX for a fax sent on 2/14/94.

See also Archive Path, Archive Index, Archive Format and EquiTrac Archive.


Archive

Path

Description:

By including this option, sent faxes will be archived to a specific path on the hard drive of the fax server or an any network drive.  RightFAX WorkServer Module Services will create the path if it doesn't already exist.  Further, the PATH can be composed of "macros" that will be replaced.  A list of the possible macros follows:~1 	=	Date in the format YYYYMMDD~2 	= 	Day of the week (SUN, MON, TUE, WED, THU, FRI, SAT)~3 	= 	Month (JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, NOV, DEC)~4 	= 	Year (YYYY)~5 	= 	Day of the month (DD)~6 	= 	Month as decimal (01, 02 ... 12)~7 	= 	User ID (truncated to 11 characters, i.e. 8.3 FAT format)~8 	= 	Week of year (00..51)~9 	= 	Bill Code #1 (truncated to 11 characters, i.e. 8.3 FAT format)~0 	= 	Bill Code #2 (truncated to 11 characters, i.e. 8.3 FAT format)

~A 	= 	Remote ID (Left to Right in 8.3 FAT format)

~B 	=	Remote ID (Right to Left in 8.3 FAT format)

The file name is a unique name assigned by the fax server and cannot be changed.  The total path length, after macro replacement, cannot exceed 128 characters.

Note:

Setting a PATH does not implicity enable archiving of sent faxes.  Such capability is enabled on a per-user basis using the FaxAdmin utilty.  Each user account has an Archive flag which needs to be enabled using FaxAdmin.

See also Archive Format, Archive History, Archive Index and EquiTrac Archive.


PCL Symbol Set - Code Page
PCL SymbolSet

Code Page

Description:

RightFAX WorkServer Module Services can more correctly interpret cover sheets when code pages other than 437 of the PCL-5 symbol set are used.  It can select the proper PCL-5 symbol set for the fax cover sheet values that are inserted on the model; i.e. substituting "John Doe" for "<toname>".  The following symbol sets are used for the following code pages:

Country	Code Page	PCL-5 	Symbol SetPCL-5 	Select Code

USA	437	PC-8 	Code Page 437 (PC)	Esc(10U

Multilingual	850	PC-850 	Multilingual (PM)	Esc(12U

Portuguese	860	PC-850 	Multilingual (PM)	Esc(12U

Fr. Canada	863	PC-850 	Multilingual (PM)	Esc(12U

Nordic	865	PC-850 	Multilingual (PM)	Esc(12U

See also PCL SymbolSet Default.


PCL Symbol Set - Default
PCL SymbolSet

Default

Description:

This is essentially the same parameter as the CodePCLSymSet, but it assumes that you have already configured a CONTROL.PCL file in the directory that will be performing PCL5 conversions (e.g. \rightfax\worksrv1) and are using the -c option in the laseros2.cfg or laseros1.cfg files.  The CONTROL.PCL will contain certain PCL control codes for your customized conversions; in the DefaultPCLSymSet line all you need to do is specify which code set you wish to use.

Country	Code Page	PCL-5 	Symbol SetPCL-5 	Select Code

USA	437	PC-8 	Code Page 437 (PC)	Esc(10U

Multilingual	850	PC-850 	Multilingual (PM)	Esc(12U

Portuguese	860	PC-850 	Multilingual (PM)	Esc(12U

Fr. Canada	863	PC-850 	Multilingual (PM)	Esc(12U

Nordic	865	PC-850 	Multilingual (PM)	Esc(12U

See also PCL SymbolSet Code Page.


Optimize Faxing - Short Body
Optimize Faxing

Short Body

Description:

If this parameter is checked ON, then the fax body pages will only be as long as the text requires.  Otherwise the fax body pages will be padded out to the page size as set by the PCL-5 control codes and the PCL-5 configuration.  Sending short pages can reduce transmission times.

See also Short Covers.


Optimize Faxing - Short Covers
Optimize Faxing

Short Covers

Description:

If this parameter is checked ON, then the fax cover sheet will be only as long as the text requires.  Sending short cover sheets can reduce transmission times.  If this parameter is unchecked then cover sheets will be padded to fill out the entire page.

See also Short Body.


PostScript Page

Description:

This parameter can have one of the following values: LETTER, LEGAL, or A4.  This determines the page size that GoScript uses to image faxes.  This parameter is necessary because there is no defined way in the PostScript language to set the page size.


Select Workserver to Edit

Description:

This parameter selects the Workserver process configuration that you will edit.


Number of Workservers
NumWorkservers

Description:

This parameter sets the number of  RightFAX WorkServer Module Service which will be running concurrently on the RightFAX FaxServer.  If you set the number of RightFAX WorkServer Module Services greater than the number which you currently have, RightFAX will create a new directory for the RightFAX WorkServer Module Service and copy the appropriate files.


Frequency

Description:

The FREQUENCY parameter indicates how often RightFAX WorkServer Module Service should query RightFAX Database Module Service for any new requests.  This value is specified in seconds.  If you only have one RightFAX WorkServer Module Service, 5 or 10 seconds is appropriate.  If you have multiple RightFAX WorkServer Module Services, then a larger frequency prevents request storms from burdening the RightFAX Database Module Service (you don't want RightFAX WorkServer Module Services to keep the RightFAX Database Module Service so busy that clients cannot get serviced in a timely manner.


Print Time Strip
Time Strip

Print Time Strip

Description:

This adds a line at the top of every fax printed to a network printer.  This added line includes information about:  the time of arrival (for a received fax), elapsed transmission time, time printed, and the image file name.

See also Time Strip Name.


Automatically Start the Service

Description:

This parameter tells the Faxserver whether or not it should automatically start the RightFAX WorkServer Module Services when it is starting up.  The only time this should be un-checked is if you going to start the RightFAX WorkServer Module Service on another machine, or would like to start it manually, usually for debugging a problem..

If you check this, then the Service will NOT be automatically started by the RightFAX Server Module Service.


Automatic Billing Code Import
Billing Code Import Interval

Description:

This parameter sets the interval, in minutes, at which a RightFAX WorkServer Module Service should check for a new billing code delta file.  At every interval, the RightFAX WorkServer Module Service checks for the file, CODECHG.CSV, in its own directory.  If the file exists, the RightFAX WorkServer Module Service proceeds to import the adds, changes and deletions named in the file.

A value of 15 minutes is reasonable for checking for the file.   A value of  0, tells the RightFAX WorkServer Module Service NOT to check for the file.


Print Time Strip Name
Time Strip

Name

Description:

When included with the Print Time Strip parameter, this also prints the name specified in the value.  Default value for this parameter is the name of the fax server.  (If you don't include this line, RightFAX will automatically print the name of the fax server.)

See also Print Time Strip.